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SPECIFICATION 

IBM Docket No. STL9-2000-0069 
TO ALL WHOM IT MAY CONCERN: 

BE IT KNOWN that I, John R. Ehrman of Sunnyvale, California and citizen of the United 
States have invented new and useful improvements in 



METHOD OF, SYSTEM FOR, AND COMPUTER PROGRAM PRODUCT FOR 
SCOPING THE CONVERSION OF UNICODE DATA FROM SINGLE BYTE 
CHARACTER SETS, DOUBLE BYTE CHARACTER SETS, OR MIXED 
CHARACTER SETS COMPRISING BOTH SINGLE BYTE AND DOUBLE BYTE 

CHARACTER SETS 

of which the following is a specification: 
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1 METHOD OF, SYSTEM FOR, AND COMPUTER PROGRAM PRODUCT FOR 

2 SCOPING THE CONVERSION OF UNICODE DATA FROM SINGLE BYTE 

3 CHARACTER SETS, DOUBLE BYTE CHARACTER SETS, OR MIXED 

4 CHARACTER SETS COMPRISING BOTH SINGLE BYTE AND DOUBLE BYTE 

5 CHARACTER SETS 
6 

7 

8 CROSS-REFERENCE TO RELATED APPLICATIONS 

9 

10 Application Serial Number , filed concurrently herewith on July 10, 2000 

1 1 for METHOD OF, SYSTEM FOR, AND COMPUTER PROGRAM PRODUCT FOR 

12 CREATING AND CONVERTING TO UNICODE DATA FROM SINGLE BYTE 
ll CHARACTER SETS, DOUBLE BYTE CHARACTER SETS, OR MIXED 

l|| CHARACTER SETS COMPRISING BOTH SINGLE BYTE AND DOUBLE BYTE 

m CHARACTER SETS (IBM Docket STL9-2000-0055), currently co-pending, and assigned to 
the same assignee as the present invention; and 

V^' Application Serial Number , filed concurrently herewith on July 10, 2000 

1® for DATA STRUCTURE FOR CREATING, SCOPING, AND CONVERTING TO 

m UNICODE DATA FROM SINGLE BYTE CHARACTER SETS, DOUBLE BYTE 

M CHARACTER SETS, OR MIXED CHARACTER SETS COMPRISING BOTH 

; :: 

m SINGLE BYTE AND DOUBLE BYTE CHARACTER SETS (IBM Docket STL9-2000- 

22 0068), currently co-pending, and assigned to the same assignee as the present invention. 

23 The foregoing copending appUcations are incorporated herein by reference. 
24 

25 

26 A portion of the Disclosure of this patent document contains material which is subject 

27 to copyright protection. The copyright owner has no objection to the facsimile reproduction by 

28 anyone of the patent document or the patent disclosure, as it appears in the Patent and 

29 Trademark Office patent file or records, but otherwise reserves all copyright rights whatsoever. 
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1 BACKGROUND OF THE INVENTION 

2 
3 

4 1. Field of the Invention 

5 

6 The present invention relates in general to coded character sets for representing 

7 characters in a computer program, and more particularly to a creation of Unicode characters by 

8 converting from non-Unicode characters. 
9 

10 

I I 2, Description of the Related Art 

12 

131 Unicode is a new internationally standardized data encoding for character data which 

ft allows computers to exchange and process character data in any natural language text. Its most 

W common usage is in representing each character as a sixteen-bit number. This is sometimes 

III called a "double-byte" data representation as a byte contains eight bits. 

W Most existing computer hardware and software represents specific sets of characters in 

Ift an eight-bit code, of which ASCII (American National Standard Code for Information 

2QE Interchange) and EBCDIC (Extended binary-coded decimal interchange code) are typical 

W examples. In such an eight-bit representation (also known as a single-byte representation), the 

22 limit of two-hundred-fifty-six (256) unique numeric values imposes a restriction on the set of 

23 distinct characters that may be encoded using the two-hundred-fifty-six distinct values. Thus, it 

24 is necessary to define different sets of encodings for each desired set of characters. 
25 

26 The chosen set of characters is called a "Character Set". Each member of the character 

27 set can be assigned a unique eight-bit numeric value ("Code Point") from the set of the two- 

28 hundred-fifty-six distinct values (Code Points). A group of assignments of characters and 

29 control function meanings to all available code points is called a "Code Page"; for example, the 
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1 assignments of characters and meanings to the two-hundred- fifty-six code points (0 through 

2 255) of an 8-bit code set is a Code Page. The combination of a specific set of characters and a 

3 specific set of numeric value assignments is called a "Coded Character Set". To distinguish 

4 among the many different assignments of characters to codings, each Coded Character set is 

5 assigned an individual identification number called a "Coded Character Set ID" (CCSED). 
6 

7 Li situations involving ideographic scripts such as Chinese, Japanese, or Korean, a 

8 hybrid or mixed representation of characters is sometimes used. Because the number of 

9 ideographic characters greatly exceeds the two-hundred-fifty-six possible representations 

10 available through the use of an eight-bit encoding, a special sixteen-bit encoding may be used 

1 1 instead. To manage such sixteen-bit representations in computing systems and devices built for 

12 eight-bit representations, two special eight-bit character codes are reserved and used in the 
l^li eight-bit-character byte stream to indicate a change of alphabet representation. Typically, a 
]3[ string of characters will contain eight-bit characters in a single-byte representation. When the 
M first of the two special character codes (commonly called a "Shift-Out" character) is 

|i encountered indicating a switch of alphabets, the bytes subsequent to the Shift-Out character 

17" are interpreted as double-byte pairs encoded in the special sixteen-bit double-byte encoding. 

i§ At the end of the double-byte ideographic string, the other special eight-bit character code 

19^ (commonly called a "Shift-hi" character) is inserted to indicate that the following eight-bit 

24, bytes are to be interpreted as single-byte characters, as were those characters preceding the 

M "Shift-Out" character. This hybrid representation is sometimes also called a "double-byte 

22 character set" (DECS) representation. When such DECS strings are mixed with SECS 

23 characters, the representation is sometimes called a "mixed SECS/DCBS" representation. 
24 

25 Ideographic characters may also be represented as sixteen-bit characters in strings 

26 without any SECS characters other than the special initial "Shift-Out" and final "Shift-In" 

27 character codes if they are used in a context where it is known that there are no mixtures of 

28 eight-bit characters and sixteen-bit characters. Such usage is sometimes called "pure DECS". 

29 The Shift-Out and Shift-In codes are still required as the text of the remainder of the program 
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1 may use single-byte encodings. 
2 

3 To illustrate, assume that the "Shift-Out" character is represented by the character '<* 

4 and that the "Shift-Li" character is represented by the character Then each of the three 

5 representations just described may be written as strings of these forms: 

6 'abcDEF' SBCS string 

7 'AB<wxyz>CD' mixed SBCS/DBCS string 

8 '<wxyz>' pure DBCS string 
9 

10 The actual computer storage representation of each of these three character formats 

1 1 would generally be similar to the following representations. For example, the SBCS string 
IX. would generally appear in storage as follows: 

1^ + + + + + + + 

M 'abcDEF' |a|b|c|D|E|F| 

+ — + — + — + — + — + — -h 
iS? Six bytes, one byte per character 

m 

ik The hexadecimal encoding of this string in a standard representation may appear as: 

+ — + — + — + — + — + — + 

M I 81| 81| 83| C4| C5| C5 | 
2j| + + + + 4- + + 

23 After translation to Unicode, the same characters may be represented by the following bytes 

24 (shown in hexadecimal encoding): 

25 + + — + — + — + — + + + — + + — + — + — + 

26 I 00 61| 00 62| 00 63 i 00 44 | 00 45| 00 46| 

27 + + + + + + + + + + + + + 

28 Twelve bytes, two bytes per character 

29 
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1 Similarly, the computer storage representation of a mixed SBCS/DBCS string may 

2 generally appear as follows where ' wxyz' represents the four bytes needed to encode the two 

3 ideographic DBCS characters between the Shift-Out and Shift-In characters, and the strings 

4 indicate the specific encodings assigned to the representations of the DBCS characters: 
5 

g + + — + — + — + — -h — + — + — + + + 

7 'AB<wxyz>CD' |A|B|<|????|????|>|ClD| 

8 + h + + + + + + + + + 

9 Ten bytes 
10 

1 1 The hexadecimal encoding of this string in a standard representation may appear as follows 

12, (wherein the Shift-Out and Shift-hi characters have encodings X'OE' and X'OF' respectively): 
1^ +---+---+---+---+---+---+---+---+---+---+ 
^ I Cl| C2| 0E| ??| ??| ??| ??| 0F| C3| C4| 

+ + + + + H + + + + + 

s 

llTl When translated to Unicode, the same characters may be represented by the these bytes (shown 

1^ in hexadecimal encoding): 

1^ + + + + + + -f + + 4- + + 

I 00 41| 00 42| ?? ?? I ?? ?? I 00 43| 00 44 | 

25 + + + + + + + + H + + + H 

it Twelve bytes, two bytes per character 

23 Note that the Shift-Out and Shift-hi characters have been removed, as they are not necessary in 

24 the Unicode representation. 
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1 For the third type of character string containing pure DBCS characters, the computer 

2 storage representation may appear as follows: 

3 -i- — + — + — + — + — + — + 

4 »<wxyz>' |<|????|????|>| Six bytes 

5 4- -h + + + + + 

6 The hexadecimal encoding of this string in a standard representation may appear as follows 

7 (wherein the Shift-Out and Shift-Li characters have encodings X'OE' and X'OF' respectively): 
g + — + — + — + ^ — + — + 

9 I OE I ?? I ?? I ?? 1 ?? I OF I 

10 + + + + + H + 

11 

12 When translated to Unicode, the same characters would be represented by the these bytes 

(shown in their hexadecimal encoding): 
llfl + — + — + — + — + 

ifS I ?? ?? I ?? ?? I 

1^ +- - -+---+- - - 

Vt Four bytes, two b)^es per character 

1« 

In typical usage, many coded character sets are used to represent the characters of 

2i£ various national languages. As computer applications evolve to support a greater range of 

2CU national languages, there is a corresponding requirement to encompass a great multiplicity of 

22 "alphabets". For example, a software supplier in England may provide an account 

23 management program to a French company with a subsidiary in Belgium whose customers 

24 include people with names and addresses in Danish, Dutch, French, Flemish, and German 

25 alphabets. If the program creates billings or financial summaries, it must also cope with a 

26 variety of currency symbols. Using conventional technology, it may be difficult, or even 

27 impossible, to accommodate such a variety of alphabets and characters using a single eight-bit 

28 coded character set. 
29 

30 In other applications, a program may be required to present messages to its users in any 
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1 of several selectable national languages (this is often called "internationalization"). Creating 

2 the message texts requires that the program's suppliers be able to create the corresponding 

3 messages in each of the supported languages, which requires special techniques for handling a 

4 multiplicity of character sets in a single application. 
5 

6 Unicode offers a solution to the character encoding problem, by providing a single 

7 sixteen-bit representation of the characters used in most applications. However, most existing 

8 computer equipment creates, manages, displays, or prints only eight-bit single-byte data 

9 representations. In order to simplify the creation of double-byte Unicode data, there is a need 

10 for ways to allow computer users to enter their data in customary single-byte, mixed 

1 1 SBCS/DBCS, and pure DBCS formats, and then have it converted automatically to the double- 
]& byte Unicode representation. 
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1 SUMMARY OF THE INVENTION 

2 
3 

4 The present invention comprises a method, system, article of manufacture, and a 

5 computer program product for representing characters in a computer program, and more 

6 particularly to a creation of Unicode characters by converting from non-Unicode characters. 

7 A preferred embodiment of the present invention provides methods for specifying the types of 

8 constants whose character values are to be converted to Unicode; for specifying which code 

9 page or pages are used for specifying the character encodings used in the source program for 

10 writing the character strings to be converted to Unicode; and that can be used to perform 

1 1 conversions from SBCS, mixed SBCS/DBCS, and pure DECS character strings to Unicode. A 
12, syntax suitable for specifying character data conversion from SBCS, mixed SBCS/DBCS, and 
Idf pure DBCS representations to Unicode utilizes an extension to the conventional constant 

M subtype notation, hi converting the nominal value data to Unicode, currently relevant SBCS 

iJS and DBCS code pages are used, as specified by three levels or scopes derived from either 

M global options, from local AOPTIONS statement specifications, or from constant-specific 

U modifiers. Global code page specifications apply to the entire source program. These global 

M specifications allow a programmer to declare the source-program code page or code pages just 

i9 once. These specifications then apply to all constants containing a request for conversion to 

II Unicode. Local code page specifications apply to all subsequent source-program statements. 

if These local specifications allow the programmer to create groups of statements containing 

22 Unicode conversion requests, all of which use the same code page or code pages for their 

23 source-character encodings. Code page specifications that apply to individual constants allow a 

24 very detailed level of control over the source data encodings to be used for Unicode 

25 conversion. The conversion of source data to Unicode may be implemented inherently to the 

26 translator (assembler, compiler, or interpreter) wherein it recognizes and parses the complete 

27 syntax of the statement in which the constant or constants is specified, and performs the 

28 requested conversion. Alternatively, an external function may be invoked by a variety of 

29 source language syntaxes which parses as little or as much of the source statement as its 
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1 implementation provides, and returns the converted value for inclusion in the generated 

2 machine language of the obj ect program. Alternatively, the conversion may be provided by the 

3 translator's macro instruction definition facility. 
4 

5 One aspect of a preferred embodiment of the present invention provides for the 

6 specification of the types of constants whose character values are to be converted to Unicode. 
7 

8 Another aspect of a preferred embodiment of the present invention provides for the 

9 specification of which code page or pages are used for specifying the character encodings used 
10 in the source program for writing the character strings to be converted to Unicode. 

11 

\g Another aspect of a preferred embodiment of the present invention performs 

1§ conversions fi-om SBCS, mixed SBCS/DBCS, and pure DECS character strings to Unicode. 

1^^ Another aspect of a preferred embodiment of the present invention provides a syntax 

]M suitable for specifying character data conversion from SBCS, mixed SBCS/DBCS, and pure 

17" DECS representations to Unicode utilizing an extension to the conventional constant subtype 

IS! notation. 

IP^ 

Ml Another aspect of a preferred embodiment of the present invention converts a nominal 

M value data to Unicode using currently relevant SBCS and DBCS code pages as specified by a 

22 level or scope. 
23 

24 Another aspect of a preferred embodiment of the present invention provides a global 

25 level or scope comprising a global code page specification which applies to an entire source 

26 program. 
27 

28 Another aspect of a preferred embodiment of the present invention provides a local 

29 level or scope comprising a local code page specification which applies to all subsequent 
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1 source-program statements. 
2 

3 Another aspect of a preferred embodiment of the present invention provides an 

4 individual constant level or scope comprising a code page specification that applies to an 

5 individual constant. 
6 

7 A preferred embodiment of the present invention has the advantage of providing ease of 

8 Unicode data creation: data can be entered into a program using familiar and customary 

9 techniques, and in the user's own language and preferred character sets, vv^ithout having to know 
1 0 any details of SBCS, DECS, or Unicode character representations or encodings. 

11 

A preferred embodiment of the present invention has the further advantage of providing 

r§ an ability to handle multiple single-byte and double-byte input data encodings, each specific to 

lf|. a national language or a national alphabet. Such input data may be written in several 

1^ convenient forms, such as SBCS, mixed SBCS/DBCS, and pure DECS. 

s 

1I7 A preferred embodiment of the present invention has the further advantage of providing 

M a variety of scopes for specifying controls over source data representations and encodings, 

M such that the user has complete control over the range of these specifications, ranging from 

m global (applying to all requested conversions in the entire program), local (applying to a range 

If of statements containing data to be converted) to individual or constant-specific (applying to a 

22 single instance of data to be converted). 
23 

24 A preferred embodiment of the present invention has the further advantage of providing 

25 an open-ended design allowing easy addition of supported character sets, by simply providing 

26 additional Mapping Tables for each supported character set, and without any need to modify 

27 the internal logic of the translator (assembler, compiler, or interpreter) to be cognizant of such 

28 added character sets and tables. 
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1 A preferred embodiment of the present invention has the further advantage of having no 

2 dependence on operating system environments or run-time conversion services, which may or 

3 may not be available in the environment in which character data in the source programs are 

4 being converted to Unicode and translated to machine language. 
5 

6 A preferred embodiment of the present invention has the further advantage of providing 

7 a special language syntax specifying constants to be converted to Unicode, creating no conflicts 

8 with existing applications. This syntax is also a natural and intuitively familiar extension of the 

9 existing syntax for specifying character constants. 
10 

1 1 A preferred embodiment of the present invention has the further advantage of having no 

12 need to prepare nor accept programs written using Unicode characters, and no need for 

Iffi special Unicode-enabled input/output devices or mapping software, because of the ease of data 

]X creation and the variety of data formats described above. 

Igi A preferred embodiment of the present invention has the further advantage of providing 

IT an ability to implement conversions in multiple ways to provide flexibility, including 

1® implementations in the translator itself ("native" implementation), or by using macro or 

l|i preprocessor instructions, or by utilizing the translator's support for externally-defined and 

M externally-written functions. 

ill 

22 A preferred embodiment of the present invention has the further advantage of providing 

23 an ability to support normal sixteen-bit Unicode and Unicode UTF-8 character formats as the 

24 results of converting any of the source data formats described above. 
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1 BRIEF DESCRIPTION OF THE DRAWINGS 

2 
3 

4 For a more complete understanding of the present invention and the advantages thereof, 

5 reference is now made to the Description of the Preferred Embodiment in conjunction with the 

6 attached Drawings, in which: 
7 

8 Figure 1 is a block diagram of a distributed computer system used in performing the 

9 method of the present invention, forming part of the apparatus of the present invention, and 

10 which may use the article of manufacture comprising a computer-readable storage medium 

1 1 having a computer program embodied in said medium which may cause the computer system 
1 2„ to practice the present invention; 

l| 

ll^' Figure 2 is a block diagram of a mapping table data structure preferred in carrying out a 

1^ preferred embodiment of the present invention; 

li 

ff Figure 3 and Figure 4 are flowcharts of method steps preferred in carrying out a 

Ip preferred embodiment of the present invention; and 

1^ 

^ Figures 5, 6, and 7 are listings of computer program code which implements the 

method steps preferred in carrying out a preferred embodiment of the present invention. 
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1 DESCRIPTION OF THE PREFERRED EMBODIMENT 

2 
3 

4 Referring first to Figure 1, there is depicted a graphical representation of a data 

5 processing system 8, which may be utilized to implement the present invention. As may be 

6 seen, data processing system 8 may include a plurality of networks, such as Local Area 

7 Networks (LAN) 10 and 32, each of which preferably includes a plurality of individual 

8 computers 12 and 30, respectively. Of course, those skilled in the art will appreciate that a 

9 plurality of Intelligent Work Stations (IWS) coupled to a host processor may be utilized for 

10 each such network. Each said network may also consist of a plurality of processors coupled via 

1 1 a communications medium, such as shared memory, shared storage, or an interconnection 
12,, network. As is common in such data processing systems, each individual computer may be 
Iffi coupled to a storage device 14 and/or a printer/output device 16 and may be provided with a 
yk pointing device such as a mouse 17. 

M 

Igl The data processing system 8 may also include multiple mainframe computers, such as 

U mainframe computer 18, which may be preferably coupled to LAN 10 by means of 

1^ communications link 22. The mainframe computer 18 may also be coupled to a storage device 

#; 20 which may serve as remote storage for LAN 10. Similarly, LAN 10 may be coupled via 

2|| communications link 24 through a sub-system control unit/communications controller 26 and 

2¥ communications link 34 to a gateway server 28. The gateway server 28 is preferably an IWS 

22 which serves to link LAN 32 to LAN 10. 
23 

24 With respect to LAN 32 and LAN 10, a plurality of documents or resource objects may 

25 be stored within storage device 20 and controlled by mainframe computer 18, as resource 

26 manager or library service for the resource objects thus stored. Of course, those skilled in the 

27 art will appreciate that mainframe computer 18 may be located a great geographic distance 

28 from LAN 10 and similarly, LAN 10 may be located a substantial distance from LAN 32. For 

29 example, LAN 32 may be located in Belgium while LAN 10 may be located within England 
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1 and mainframe computer 18 may be located in New York. 
2 

3 Software program code which employs the present invention is typically stored in the 

4 memory of a storage device 14 of a stand alone workstation or LAN server from which a 

5 developer may access the code for distribution purposes, the software program code may be 

6 embodied on any of a variety of known media for use with a data processing system such as a 

7 diskette or CD-ROM or may be distributed to users from a memory of one computer system 

8 over a network of some type to other computer systems for use by users of such other systems. 

9 Such techniques and methods for embodying software code on media and/or distributing 
10 software code are well-known and will not be fiirther discussed herein. 

11 

12, As will be appreciated upon reference to the foregoing, it may be desirable for a user to 

W develop a multi-lingual or multi-alphabet software application. For example, a user of a 

lit software supplier in England may develop an account management program on a workstation 

iS 12 for use on a French company's computer 26 wherein the French company has a subsidiary 

W in Belgium running a computer 28 which must process requests from users operating 

ll? computers 30, each of which may be interfacing in a different language, such as Danish, Dutch, 

1^ French, Flemish, or German. The present invention provides character specification and 

Ml conversion capabilities to accommodate such a variety of alphabets and characters. 

2f The following description of an assembler based preferred embodiment of the present 

22 invention assumes familiarity with the assembly language described in "IBM High Level 

23 Assembler for MVS & VM & VSE Language Reference, Release 3", IBM Manual Number 

24 SC26-4940-02, and the assembler options and external ftmction interfaces described in "IBM 

25 High Level Assembler for MVS & VM & VSE Programmer's Guide, Release 3", IBM Manual 

26 Number SC26-4941-02. While this preferred embodiment of the present invention is described 

27 in the context of the IBM Assembler Language, it can apply to other language translators such 

28 as assemblers, compilers, and interpreters. 
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1 The invention concerns the creation of Unicode data, not its processing. The invention 

2 may be described in three ways: 

3 A. Methods for specifying the types of constants whose character values are to be 

4 converted to Unicode; 

5 B. Methods for specifying which code page or pages are used for specifying the character 

6 encodings used in the source program for writing the character strings to be converted 

7 to Unicode.; and 

8 C. Methods that can be used to perform conversions from SBCS, mixed SBCS/DBCS, 

9 and pure DBCS character strings to Unicode. 
10 

11 hi the following descriptions, the terms "source" or "source string" refer to the 

12 characters to be converted to Unicode, and "source code page" refers to the particular encoding 
Idl used to represent the source- string characters as numeric quantities. Similarly, the terms 

"target" or "target string" refer to the set of Unicode characters into which the source string is 

IP being converted. 
iS 

iV" Standard Syntax 

Ip The terminology of the IBM Assembler Language is used to specify character constants. 

The DC ("Define Constant") instruction directs the Assembler to convert the characters 

2|lJ enclosed in apostrophes specified in the operand field to the proper machine language 

^1 representation: 

22 DC C\..SBCS characters...' Convert '...SBCS characters...' to the 

23 proper machine language representation. 

24 DC C'...SBCS and DBCS characters...' Convert '...SBCS and DBCS characters...' 

25 to the proper machine language 

26 representation. Requires that the DBCS 

27 option be specified. 

28 DC G'...pure DBCS characters...' Convert '...pure DBCS characters...' to the 

29 proper machine language representation. 



STL9-2000-0069 



1 Requires that the DBCS option be 

2 specified. 
3 

4 The DC (Define Constant) statement has this general form: 

5 label DC (DUPLICATION„FACTOR)(TYPE)(MODIFIERS)'(NOMINAL_VALUE)* 

6 where the parentheses simply delimit the various fields, and are not part of the syntax of the 

7 statement, hi general, only the TYPE and NOMINAL_VALUE fields are required. For 

8 example, a statement defining a character constant could be written: 

9 DC CThis is a character constant' 

1 0 where the TYPE is indicated by the letter C. 
11 

M hi the general form of the DC statement, each of the parenthesized terms has the 

1 W following meanings : 

lb 

1^ 1 . The optional DUPLICATIOKJACTOR field specifies that the constant defined by the 

1^1 following elements should be repeated a specified number of times. For example, 

m DC SC'XYZ-' 

would generate a machine language constant from the character string 

Ip 'XYZ=XYZ=XYZ=*, containing three repetitions of the nominal value string 'XYZ='. 

21 2. TYPE specifies the type of encoding to be created for the values specified in the 

22 NOMINAL_VALUE field. In a preferred embodiment of the present invention, types 

23 of specific interest and applicability are Types C and G, for "Character" and "Graphic" 

24 constants, respectively. Other TYPE values are used to indicate that the 

25 NOMESfAL_VALUE data should be converted to machine language data 

26 representations such as binary integer, floating point, packed decimal, and others as 

27 described in the "High Level Assembler Language Reference" citation. 
28 

29 The TYPE specification may also include a "subtype" specification to provide 
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1 additional refinements in the type of conversion to be performed. For example, the "D" 

2 type indicates that the NOMINAL_VALUE is to be converted to an eight-byte floating 

3 point representation; two subtypes are supported, such that "DH" indicates conversion 

4 to hexadecimal floating point, and "DB" indicates conversion to binary floating point. 
5 

6 3 . MODIFffiRS specify additional information to be used in creating the generated 

7 machine language constant. A preferred embodiment of the invention is primarily 

8 concerned with the "Length" modifier, which asserts the exact length required for the 

9 generated data. An additional modifier may be used for specifying code pages to be 
10 used in converting individual constants. 

11 

iS 4. NOMINAL_VALUE is the data to be converted. A preferred embodiment of the 

1^1 present invention is concerned with character data in three forms: SBCS data, mixed 

l|j SBCS/DBCS data, and pure DECS data. 

li 

Yff Literals 

Literals are a convenient form of declaring a constant in the immediate context of its 

10 use. For example, to set the address of a character constant into General Purpose Register 2, a 

2|| programmer may write the "Load Address" (LA) instruction thus: 

21 LA 2 =C A Character Constant' 

22 where the equal sign indicates to the assembler that the following operand is a literal constant. 

23 The assembler effectively creates a hidden internal name for the constant, replaces the Uteral 

24 operand in the statement by the internal name, and places the text of a statement defining the 

25 constant labeled with the internal name in a designated (or default) place in the program. This 

26 saves the programmer from having to write two statements, such as: 

27 L A 2 , Char_Const 

28 — other statements 

29 Char-Const DC CA Character Constant' 
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1 Literals can easily be supported for all constant types described in this preferred 

2 embodiment of the present invention, and will therefore not be discussed further; such support 

3 is assumed throughout. 
4 

5 The assembler also supports specialized forms of character-like data called "self- 

6 defining terms". These comprise decimal, binary, hexadecimal, character, and graphic (pure 

7 DBCS) forms. The values of all self-defining terms are fixed and predefined by the assembler. 

8 For example, the self-defining terms 1 93, B" 1 1 00000 1 X'C 1 ', and C'A' are required to have 

9 identical values. For this reason, no dependence on code page specifications can be allowed for 

1 0 character or graphic self-defining terms, as their values would not be fixed. 
11 

12. In the IBM High Level Assembler, the syntactic character set consists of 

liJI (a) upper-case and lower-case letters; 

ilk (b) decimal digits; and 

M (c) the special characters: + -/ *., ()@#_&' = blank. 

11 (d) The syntactically significant alphabetic character "$" ("currency symbol") is not invariant 
ly' across EBCDIC code pages; the Assembler Language requires it to have encoding X'5B', or 9 1 
iS decimal. 

1^ 

2^ Other characters are invariant across code pages, but they are not syntactically 

'i¥ significant: 

22 ;:?"%<> 

23 

24 The invariance or non-invariance of various syntactic characters is not significant to this 

25 preferred embodiment of the present invention, other than providing a vehicle for the proper 

26 recognition of character strings to be converted to Unicode. The character set used in character 

27 data may contain SBCS and DBCS character encodings from many possible code pages 

28 without affecting the syntactic or semantic behavior of the program, because the contexts 

29 specifying data to be converted to Unicode are limited and well defined. 
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1 This preferred embodiment supports the common programming practice that source 

2 programs (symbols, operation codes, etc.) are always created using a syntactic character set, 

3 which includes those characters needed by the assembler or other programming-language 

4 translator to correctly parse and tokenize the elements of the source program, and to identify 

5 those program elements specifically requesting conversion to Unicode. Conversion-specific 

6 character data appears only in restricted contexts, between the enclosing apostrophes of the 

7 CU-type or GU-type constants described below. Text to be converted may therefore be 

8 encoded in any desired manner. 
9 

10 Although the preferred embodiment described uses the Extended Binary Coded 

1 1 Decimal Interchange Code (EBCDIC) for all but character data, this invention applies to any 

12 conventional character set used for creating programs, such as ASCII. 
If 

itfe 

A. Source Data Specification Extensions for Unicode 

Ij' A syntax suitable for specifying character data conversion from SBCS, mixed 

iS SBCS/DBCS, and pure DBCS representation to Unicode utilizes the constant subtype notation 

# described above. To specify that the nominal value of character data is to be converted to 

2§ Unicode, a programmer may write: 

f? DC CU'...SBCSdata...' Convert SBCS to Unicode 

22 DC CU'...SBCS/DBCS data...' Convert mixed SBCS/DBCS to Unicode 

23 Requires DBCS option 

24 DC GU'...pure DBCS data...' Convert pure DBCS data to Unicode 

25 Requires DBCS option 

26 The first of these is called "pure SBCS data" or simply "SBCS data". The second is called 

27 "mixed SBCS/DBCS data", or simply "mixed data". The third is called "pure DBCS data". 
28 

29 In the preferred embodiment using the IBM High Level Assembler, the second and third 
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1 of these examples require that the DECS option be specified so that mixed SBCS/DBCS data is 

2 recognized correctly, but other forms of recognition rules or syntaxes for the nominal value 

3 could also be used. 
4 

5 Another language extension provided by the preferred embodiment defines a new 

6 constant type specifically for Unicode by assigning a TYPE code V\ Thus, a constant to be 

7 converted to Unicode may be written: 

8 DC UText to be converted' 

9 which could be equivalent in other respects to a constant of type C. If this form is chosen, an 

10 additional type letter would also have to be assigned to accommodate pure DECS data, by 

1 1 analogy with the G-type constant. Because the assembler has already assigned a large range of 
12, letters for constant types, the method using a U' subtype described above is more economical 
Iffi in its use of the available set of type codes. 

l^f hi converting the nominal value data to Unicode, the assembler uses the currently 

IS relevant SBCS and DECS code pages, as derived from global options or from local 

ij' AOPTIONS statement specifications, or from constant- specific modifiers, as described below. 

Ip^ As with other character-based data types, no particular data alignment in storage is 

2K assumed. However, since Unicode data naturally occurs in two-byte (sixteen-bit) forms, data 

2V alignment on two-byte boundaries could easily be supported if processing efficiencies indicate 

22 that doing so would be beneficial. 
23 

24 To simplify usage of these new constant types, the syntax of CU-type and GU-type 

25 constants preferably should be unchanged from the current language definition for C-type and 

26 G-type constants. This allows users who are familiar with existing coding styles and 

27 conventions (i.e., the syntax of C-type and G-type constants) to utilize this invention with 

28 minimal additional effort. 
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1 B. Methods for Specifying Source Code Pages 

2 

3 There are three levels, or "scopes", at which source code pages can be specified: 

4 1 . Global code page specifications that apply to the entire source program: these "global" 

5 specifications allow the programmer to declare the source-program code page or code 

6 pages just once. These specifications then apply to all constants containing a request for 

7 conversion to Unicode. 

8 2. Local code page specifications that apply to all subsequent source-program statements: 

9 these "local" specifications allow the programmer to create groups of statements 

10 containing Unicode conversion requests, all of which use the same code page or code 

1 1 pages for their source-character encodings. For example, a program might contain 
11 statements defining messages in each of several national languages; each grouping 
1^ could be preceded by such a "local" code page specification that applies to all the 

l|^ statements of that group, until a subsequent local specification is provided that applies 

Ig to the following group. 

Igj 3. Individual constant code page specifications that apply to individual constants: these 

l'^ ' allow a very detailed level of control over the source data encodings to be used for 

l Unicode conversion. For example, if a message in one national language must contain a 

1&^ segment written in a different national language, each segment of the message can 

2K specify the encoding used for its characters. 

2P 

22 

23 B.l. Global Source Code Page Specification 

24 

25 Global source code specifications apply to all DC ("Define Constant") statements in the 

26 source program to which Unicode conversion should be applied. These global specifications 

27 would typically be specified as "options" or "parameters" presented to the Assembler at the 

28 time it is invoked or initialized, so that the Assembler can set up any needed information that 

29 will apply to the entire source program translation. 
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1 The forms that such global source code specification options may take include: 

2 CODEPAGE(nnn) specifies a SBCS code page 

3 CODEPAGE(nim,mm...) specifies a set of SBCS code pages (Example 1) 

4 CODEPAGE(mm,sss) specifies a SBCS code page and a DBCS code page 

5 DBCS(sss) specifies a DBCS code page and enables recognition of DBCS 

6 data 

7 DBCS(sss,sss,...) specifies a set of DBCS code pages and enable recognition of 

8 DBCS data (Example 2) 

9 DBCS(CODEPAGE(sss)) specifies a DBCS code page and enables recognition of DBCS 

10 data 

11 and so forth, where values such as mm and sss are Coded Character Set IDs (CCSIDs). 

\%, Combinations and variations of the above, as well as abbreviations of the keywords, are equally 

IfP useful. Defauh code page values can also be specified at the time the Assembler is installed on 

P the user's system, allowing Unicode translations to be specified in the program without the 

lS need for invocation or initialization options. 

li 

^ In addition to these "invocation" options, the preferred embodiment allows the user to 

specify certain options to be included in the statements of the source program, using the 

# *PROCESS statement. Thus, any of the above option forms could be placed in the source 

23 module with a statement like: 
tt *PROCESS CODEPAGE(nnn) 

22 and so forth, for all possible variations. An additional capabihty is provided with the 

23 *PROCESS statement: if the OVERRIDE(...) option is specified, as in: 

24 *PROCESS OVERRIDE(CODEPAGE(nnn)) 

25 With the OVERRIDE(...) option, the user can thereby specify that no matter what CODEPAGE 

26 options are specified when the Assembler is invoked, the global CODEPAGE value or values 

27 cannot be changed from the value(s) required to produce correct conversion of the constants in 

28 the source program. 
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I B.2. Local Source Code Page Specification 

2 

3 The IBM High Level Assembler provides a mechanism allowing users to make local 

4 adjustments or overrides to options that can also be specified "globally". This mechanism is 

5 the ACONTROL statement. For example, if the user wishes that the assembler not diagnose 

6 certain substring operations, the user may specify: 

7 ACONTROL FLAG(NOSUBSTR) (Assembler ignores possibly-invalid substring 
g techniques) 

9 — statements with unusual substring coding techniques — 

10 ACONTROL FLAG(SUBSTR) (Assembler resumes checking substring 

I I techniques) 

% 

The ACONTROL statement can be used to specify localized controls over the source 

M= code pages to be used for converting designated forms of character data to Unicode. For 

lj| example, distinct groups of statements can be converted to Unicode from separate code pages 

W as follows: 

1I7 ACONTROL CODEPAGE(nnn) 

]^ — statements with character data to be converted to 

— Unicode using code page with CCSID mm 

in ACONTROL CODEPAGE(mmm) 

if — statements with character data to be converted to 

22 — Unicode using code page with CCSID mmm 
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1 Alternatively, if it is desired to specify multiple code pages to be used in converting 

2 constants in subsequent statements, the ACONTROL statements could be specified in 

3 alternative forms, such as: 

4 .* Example 3 

5 ACONTROL CODEPAGE(nnnl,nnn2,..),DCBS(CODEPAGE(sssl,sss2,...)) 

6 — statements with character data to be converted to Unicode 

7 — using code pages selected among the rum and sss values 

8 .* Example 4 

9 ACONTROL CODEPAGE(mmml ,mmm2,...),DBCS(C0DEPAGE(tttl ,ttt2,...)) 

10 — statements with character data to be converted to Unicode 

1 1 — using code pages selected among the mmm and ttt values 

1^, Thus, all the various formats of "global" options could be specified on ACONTROL 

1# statements. 

ft 

M In cases where the user wishes to revert from a local source code page specification to 

f§ the global source code page specification, the following special notation may be used: 

W ACONTROL CODEPAGE(*) (Revert to global source code page specifications) 

ti 

ff Later, conversion and implementation techniques are described that involve methods 

29 that do not require direct implementation in the assembler itself, such as macro instructions and 

if external functions. To assist such methods, the assembler can capture information from the 

22 options and/or ACONTROL statements in global system variable symbols. These system 

23 variable symbols are a method whereby the assembler can provide environmental and status 

24 information to macros and functions, hi implementing conversion to Unicode data formats, the 

25 assembler can capture the designations of current code pages in system variable symbols such 

26 as: 

27 &SYS_SBCS_CODEPAGE current SBCS code page 

28 &SYS_DBCS_CODEPAGE current DECS code page 

29 The advantages of this increment in assembler capability will be illustrated below. 



STL9-2000-0069 



25 



1 B.3. Specifying Source Code Page for Individual Constants 

2 

3 The most discriminating level of code page specification is at the level of an individual 

4 constant. This invention involves adding a novel modifier, P meaning "Code Page"--, to the 

5 existing syntax for specifying constants to provide information about the code page or code 

6 pages used to create the source data for the constant. 
7 

8 To provide code page specifications for individual constants, another novel form of 

9 modifier is introduced: 

10 DC CUP(nnn)'...SBCS data...' 

1 1 which requests that the SBCS data provided using code page "nnn" be converted to Unicode. 
12^ DC CUP(nnn,sss)'...mixed SBCS/DBCS data..,' 

M requests that the mixed SBCS/DBCS data provided using code page "nrm" for the SBCS data 

lik and the code page "sss" for the DECS data be converted to Unicode, 
ly DC GUP(sss)'... pure DECS data..; 

IS requests that the pure DECS data provided using code page "sss" be converted to Unicode. 

f 

ig The above examples demonstrate the use of an explicit numeric specification of the 

Ip- value of the code page modifier. It is common practice in programming languages to use 

M symbolic forms for important numeric quantities; this invention supports this technique. For 

2i^P example, if the statement: 

22 MyCodePage Equ 1148 

23 is used to declare that the symbol "MyCodePage" is equivalent to the value 1 148, then the 

24 following two statements will be treated identically: 

25 DC CUP(1 148)Text using code page 1 148' 

26 DC CUP(MyCodePage)'Text using code page 1 148' 

27 Thus, uses of this invention are not limited to strictiy numeric specification of CCSIDs in all 

28 programming contexts. 



STL9-2000-0069 



26 



1 For situations where more than one SBCS or DECS code page is currently available (as 

2 exemplified in Examples 1, 2, 3 , and 4 above), individual constants could refer indirectly to 

3 one of the previously specified code pages using a special "indicator" notation to select the 

4 desired code page. For example, suppose the ACONTROL statement of Example 3 

5 immediately preceded these constants: 

6 DC CUP(= 1 )'Convert this with code page nnnl ' 

7 DC CUP(=2)'Convert this with code page nnn2' 

8 The notations "=1" and "=2" are intended to indicate that the first and second code pages 

9 declared in the ACONTROL statement should apply to each respective constant. The choice of 

10 the character is of course arbitrary, and could be any character not allowed in valid 

1 1 language symbols. This level of constant-specific code page specification could also be used 
1^2. with U-type constants, as described above. Additional modifiers (such as length) can also be 
1S3 supported without any modifications to the existing language rules or implementation within 
lik the assembler. 

iS 

# C. Conversion Techniques 

iF 

I'fJ Three alternative embodiments for implementing the conversion of source data to 

1^ Unicode will be described: 

Zfts 1 . The implementation is inherent to the assembler itself: the assembler recognizes and 
ff parses the complete syntax of the statement in which the constant or constants is 

22 specified, and performs the requested conversion. 

23 2. The implementation is provided in the form of an external function that can be invoked 

24 by a variety of source language syntaxes. The external fimction can parse as littie or as 

25 much of the source statement as its implementation provides, and retum the converted 

26 value to the assembler for inclusion in the generated machine language of the object 

27 program. 

28 3. The implementation is provided by the assembler's macro instruction definition facility. 

29 Each of these implementation techniques will be illustrated below. 
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1 

2 Mapping Tables 

3 

4 A key element of the conversion process is the Mapping Table, One mapping table is 

5 created for each source code page, as identified by its CCSID. Each mapping table contains the 

6 Unicode character corresponding to each single-byte or double-byte character in the specified 

7 coded character set, arranged in ascending order of the numeric encoding assigned to each 

8 source character, as illustrated in Figure 2. 
9 

10 A Mapping Table 280 typically consists of a fixed-length header 282 containing a 

1 1 number of fields identifying the table and its status, so that the assembler can verify that the 

12 correct table is being used for the requested conversion. Following the header are the Unicode 

[3 

123 characters 284, 286, ... and 288 in the exact order of the numeric encoding assigned to the 
corresponding source character. 

iW 

ig Thus, the Unicode character corresponding to the source character having a numeric 

IT encoding value of 1 would be found at 286. Similarly, the Unicode character corresponding to 

W the source character having a numeric encoding vahie of k would be fbimd at 288. 
1^ 

^ A Mapping Table for a SBCS character set would typically have two-hundred-fifty-six 

W Unicode character entries, while a mapping table for a DECS character set could have as many 

22 as sixty-five-thousand-five-hundred-thirty-six (65536) Unicode character entries. If it is known 

23 that certain restrictions may be imposed on the range of encoding values permitted for the 

24 source characters, then the contents of the mapping tables can be optimized to take advantage 

25 of those restrictions. For example, typical DBCS character encodings do not permit 

26 assignment of numeric encoding values less than sixteen-thousand-seven-hundred-five 

27 (16705), so that mapping table entries would not be necessary for converting those encodings. 
28 

29 Note that for any given constant, either one or two mapping tables will be required for 
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converting the nominal value of the constant to Unicode. For SBCS and pure DECS data, only 
a single mapping table is needed; for mixed SBCS/DBCS data, two mapping tables are 
required: one for the SBCS data and one for the DECS data. 

Table 1 illustrates typical assignments of Coded Character Set IDs (CCSIDs) 
commonly used for single-byte encodings of character sets in widespread use. Further details 
may be found in the manual "IBM National Language Design Guide, Volume 2" (manual 
number SE09-8002-03). 



Table 1 

Examples of CCSIDs for Commonly Used SBCS Character Sets 



SBCS CCSID 


DESCRIPTION 


01140 


USA, Canada, Netherlands, Portugal, Brazil, Australia, New Zealand 
(00037 with euro) 


01141 


Austria, Germany (00273 with euro) 


01142 


Denmark, Norway (00277 with euro) 


01143 


Finland, Sweden (00278 with euro) 


01144 


Italy (00280 with euro) 


01145 


Spain, Latin America (Spanish) (00284 with euro) 


01146 


United Kingdom (00285 with euro) 


01147 


France (00297 with euro) 


01148 


Belgium, Switzerland, International Latin- 1 (00500 with euro) 
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Table 2 shows examples of typical code pages used for DECS data in pure DECS or 
mixed SBCS/DBCS contexts. 



Table 2 

Examples of DECS Code Pages Suitable for Unicode Conversion 



DECS CCSID 


DESCRIPTION 


00935 


Simplified Chinese (S-Chinese) Host Mixed (including 1880 UDC and 
Extended SBCS) 


00937 


Traditional Chinese (T-Chinese) Host Mixed (including 6304 UDC and 
Extended SECS) 


04396 


Japanese Host Double-Eyte (including 1880 UDC) (User Definable 
Characters) 


09125 


Korean Host Mixed (including 1880 UDC) 



C.l. Assembler Implementation 

To adapt the CCSID of a mapping table to a format usable by internal or operating 
system services to locate the required mapping table, the assembler can employ a variety of 
methods. One such technique uses the observation that each CCSID is sixteen bits long, and 
that its hexadecimal representation therefore contains exactly four hexadecimal digits. For 
example, CCSID number 01 148 is equivalent to the hexadecimal value X'047C'. If those four 
hexadecimal digits are converted to character form, they can be attached to a standard prefix 
and used as a module name. For example, in the IBM High Level Assembler, such a module 
name could be created from a prefix 'ASMA' and a suffix given by the four hexadecimal digits, 
in this case 'ASMA047C'. This constructed name can then be used as the name of the mapping 
table in all service requests involving finding and loading the mapping table. 
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1 Referring now to Figure 3 and Figure 4, the flowcharts illustrate the operations 

2 preferred in carrying out the preferred embodiment of the present invention. In the flowcharts, 

3 the graphical conventions of a diamond for a test or decision and a rectangle for a process or 

4 function are used. These conventions are well understood by those skilled in the art, and the 

5 flowcharts are sufficient to enable one of ordinary skill to write code in any suitable computer 

6 programming language. 
7 

8 Referring first to Figure 3, the conversion proceeds as follows. After the start 302 of 

9 the conversion program, the assembler establishes at process block 304 the code page or code 

10 pages used in the source text for specifying the nominal value of the data to be converted to 

1 1 Unicode. Thereafter, at decision block 306, the assembler determines whether the mapping 
\2 tables needed for converting source data written in the source-data code pages are currently 
W available. If they are, the assembler proceeds to process block 314 to begin the conversion 

M process. Otherwise, if the mapping tables needed for the conversion are not currently available, 

then the assembler at process block 307 uses standard operating system services to load the 

IS appropriate mapping table. Thereafter, decision block 308 determines if the load of the 

t7 mapping table was successful. If for any reason the loading process fails, then the assembler at 

tK process block 310 issues appropriate error messages and terminates its attempt to convert the 

# constant 312. 

A 

2T Returning now to process block 314, to begin the conversion process the assembler 

22 parses the source string to determine the number of characters it contains. These source 

23 characters can be SBCS or DBCS characters. The number of these characters is assigned to the 

24 variable NCS. Then, at process block 316, the assembler sets a counter "K" for characters from 

25 the source string to 1 . Thereafter, assembler process block 318 extracts the K-th character from 

26 the source string. Using the binary value of the character (which will be an 8-bit value for 

27 SBCS characters, and a 16-bit value for DBCS characters), assembler process block 320 

28 extracts the Unicode character from the mapping table that whose position corresponds to that 

29 binary value. This extracted value is then stored in the K-th position of the target string, as 
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1 illustrated in Figure 2. 
2 

3 After each Unicode character is stored in the target string, assembler process block 322 

4 increases the value of K by one, and its new value is then compared to the number of characters 

5 NCS by decision block 324. If the value of K does not exceed the value of NCS, program 

6 control is returned to process block 318 to obtain and convert the next source character. If the 

7 value of K exceeds the value of NCS, then conversion of the constant is complete, and the 

8 Unicode character string is placed in the machine language of the object file for the program by 

9 process block 326. Thereafter, the program ends at process block 312. 
10 

1 1 The process of selecting source-string characters in process steps 316 through 324 of 

12 Figure 3 are described in greater detail in Figure 4 to show how SBCS and DBCS source 
13| characters are selected. The source string is assumed to have previously been validated for 
M syntactic and semantic correctness. After the start 402 of the scanning process, the scanning 

process is initialized 404 by setting a scan pointer to the address of the first byte of the source 

liji string, the nominal value of the constant. Initialization also sets a binary switch to indicate that 

1^ the scan will proceed initially in "Single-Byte" mode. This switch is also used to determine 

M which Mapping Table (SBCS or DBCS) should be used to translate source characters to 

|ft Unicode. 

M 

ip Thereafter, the byte pointed to by the scan pointer is checked by decision step 406 to 

22 see if it is a "Shift-Out" character, indicating the start of a DBCS string. If the character is not a 

23 Shift-Out character, program control proceeds to process step 408 which determines that the 

24 source characters are part of an SBCS character set. Process step 408 also uses the source 

25 character pointed to by the scan pointer as the index into the SBCS Mapping Table, as 

26 indicated in process step 320 of Figure 3, to perform the translation of process step 410 which 

27 translates the source character to Unicode. Thereafter, process step 412 increments the scan 

28 pointer by one byte to point to the next byte of the source string. Decision step 414 then 

29 determines if the scan pointer now points past the end of the source string. If the scan pointer 
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1 now points past the end of the source string, then the translation is complete, process step 416, 

2 and the assembler resumes normal statement processing, process step 418. 
3 

4 Returning now to decision step 406, if the byte pointed to by the scan pointer is a 

5 "Shift-Out" character, then control proceeds to process step 420 which increments the scan 

6 pointer by one byte, effectively discarding the "Shift-Out" character. The binary switch 

7 described at process step 404 is also set by process step 420 to indicate DECS mode, thereby 

8 allowing selection of the current DECS Mapping Table to perform the translation as illustrated 

9 in Figures 2 and 3. Thereafter, process step 422 uses the two bytes pointed to by the scan 

1 0 pointer as the source character. Process step 424 then translates this source character to 

1 1 Unicode using the DECS Mapping Table. After the translation of the DECS two-byte 

1,2, character, control proceeds to process step 426 which increments the scan pointer by two bytes 

KS to step over the DECS source character just translated. Decision step 428 tests the following 

|4 byte to determine if it is a "Shift-In" character, which would indicate the end of the DECS 

1!^ portion of the source string. If the tested byte is not a "Shift-In" character, then program 

W control returns to process step 422 to process the next DECS source character. Otherwise, if 

y the byte tested by decision step 428 is a "Shift-In" character, then program control proceeds to 

1^ process step 430 which resets the binary switch to indicate that SBCS mode is now active. 

if Thereafter, program control passes to the previously described process step 412 which 
increments the scan pointer by one byte, effectively discarding the "Shift-In" character. 

if 

22 

23 C.1.1. Length Modifiers 

24 

25 The Length modifier is supported by the assembler for most constant types. For 

26 character constants, it is written in the form: 

27 DC CL(m)This is a Character Constant' 

28 where the generated machine language object code for the constant is required to have length 

29 exactly "m" bytes. This means that the character string in the nominal value field could either 
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1 be truncated (if m is smaller than the length of the nominal value string), or padded on the right 

2 with blanks (if m is larger than the length of the nominal value string). In the case of Unicode 

3 constants the implementation may or may not require that any length modifiers of the form: 

4 DC CUL(m)'..; 

5 DC GUL(m)'<...>' 

6 must evaluate to even values of "m". If "m" is odd (indicating that a Unicode character does 

7 not contain the expected 16 bits), a diagnostic may be given and corrective action may be 

8 taken. 
9 

10 

1 1 C,2. Implementation Using Macro Instructions 

12 

S Many assembler programs sxipport some form of "macro-instruction" capability that 

IH' allows the programmer to create new capabilities whose invocations resemble ordinary 

M instructions. 

f 1 

ff C.2.1. Macro Instruction to Perform Basic Checking 

m 

ll^ The most trivial level of Unicode support could be a macro instruction whose argument 

2|i is a character string of hexadecimal digits, in which the user has manually encoded the 

20 representation of each Unicode character. The primary function of such a macro could be 

22 validate that the argument string contains a multiple of four hexadecimal digits corresponding 

23 to an integral number of Unicode characters, and that each group of four hexadecimal digits 

24 corresponds to a true Unicode character. For example, a DCUX macro instruction could be 

25 written such that the user might write: 

26 DCUX X'...hex data...' 

27 or 

28 DCUX '...hex data..; 

29 or 
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1 DCUX ...hex_data... 

2 and the macro could verify that the number of hexadecimal digits is a multiple of 4, and that 

3 the Unicode characters are valid. 
4 

5 

6 C.2,2. Macro Instruction to Perform Checking and Conversion 

7 

8 A more powerful technique for supporting the conversion of character data to Unicode 

9 characters is to create a macro definition with internal logic that performs a mapping similar to 

10 that illustrated in Figures 3 and 4. Implementation of such a macro definition could also 

1 1 include any needed mapping tables within the body of the definition. 
12 

An advantage of using macro instructions is that they utilize the existing facilities of the 

IH' assembler, and therefore do not require changes to the internal operation of the assembler. 

M Their primary disadvantage is that macro definitions must be executed interpretively when 

% invoked, so they are slower than the same function implemented "natively" in the internal logic 

W of the assembler. They also require extra coding for each additional code page being 

1® supported. Thus, macro instructions provide an excellent means for testing and validating 

lii conversion concepts, as well as a rapid development tool for situations where generality and 
speed are not critical. 

20 

22 hi a typical implementation, a macro instruction would be defined in such a way that its 

23 arguments include a character string to be converted to Unicode, and an implicit indication 

24 (using the system variable symbols described above) or explicit indication (by providing a 

25 descriptive argument) of the CCSID of the code page in which the character string is 

26 represented. The macro instruction would then generate directly the machine language 

27 constant containing the Unicode data. 
28 

29 There are many ways to use macros for Unicode conversions. To illustrate, suppose the 
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1 following syntax is defined: 

2 DCU '...character data...',CODEPAGE=nnn,DBCS=sss 

3 where the three operands have these meanings: 

4 1 . The first operand, '...character data...', consists of the character data to be converted to 

5 Unicode, enclosed in quotation marks recognizable by the macro processor. 

6 2. The second operand, CODEPAGE=nnn, specifies the SBCS code page used for 

7 encoding the first operand. If omitted, this operand would imply a default value for the 

8 code page. 

9 3. The third operand, if present, indicates that the first operand contains either mixed 

10 SBCS/DBCS or pure DBCS data, and provides the code page in which the DBCS data 

1 1 is encoded. If omitted, this operand would imply that the first operand contains only 

12 SBCS data. 

s 

& An implementation of such a macro instruction which may be used to create Unicode 

Wd character constants is illustrated in Figures 5, 6, and 7. It does not support the third operand 

1^ described above, but is intended to illustrate how a macro instruction can be used for Unicode 
conversions. The macro uses the default code page with CCSID 500, the same as that used by 

Ig the assembler for its syntactic character set plus other invariant characters. Extending the 

1^^ macro to accept other code pages is straightforward. 

m 

22 C.3. Implementation Using External Functions 

23 
24 

25 The High Level Assembler supports a powerful capability for calling extemally- 

26 provided functions that can perform a variety of processing operations. Using an external 

27 Sanction requires defining the function in such a way that the assembler can locate and call it 

28 during the assembly process, passing data supplied by the program to the fimction, and 

29 receiving values returned by the function. In the context of converting character data to 
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1 Unicode, a call to such a function could take a form such as the following: 

2 &Retumed_Val SetCF 'Ext_FuncVcharacter dataVother^parameters' 

3 The symbol "&Retumed__yar' is where the called function "Ext_Func" places its computed 

4 value as calculated from the other arguments. These arguments would typically include the 

5 character string to be converted to Unicode, the code page or code pages used in coding the 

6 character data, and any other values that might be useful to the external function. In practice, 

7 the returned value would normally be substituted into a character or hexadecimal 

8 constant, which the assembler would then map directly into the machine language form of the 

9 Unicode constant. 
10 

1 1 An external function has much of the flexibility of the assembler itself: it can access 

12 mapping tables as needed, as well as any other services of the operating system environment in 
iS which the assembler itself is executing. Any error conditions can be reported to the assembler 
]H; using a message passing interface. 

m 

Ip Further implementations of Unicode conversions could use a mixture of macro 

W instructions and external functions, in such a way that the user writes a statement such as the 

1^ following: 

li DCUNI '...character data...',CODEPAGE=37 

2!i and the macro instruction could then pass the character data, the code page CCSID, and any 

20 other useful or necessary information to an external function to perform the required 

22 conversion. It could also generate the character or hexadecimal constant directly, in such a way 

23 that the above DCUNI instruction appears to be "native" to the assembler itself. Other 

24 implementations using external functions are of course possible. 
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1 UTF-8 

2 

3 UTF-8 is a special version of the Unicode representation, chosen for its suitability for 

4 transmission over communication protocols designed for eight-bit characters. These protocols 

5 are sensitive to specific eight-bit codes (such as control characters) that could appear in a 

6 stream of valid sixteen-bit Unicode characters, and the transmission of normal Unicode data 

7 would very likely be distorted. To avoid this problem, the Unicode standard defines UTF-8 as 

8 a reversible mapping of sixteen-bit Unicode characters to a special string of one to four eight- 

9 bit bytes, such that none of the eight-bit bytes have special meanings to transmission protocols. 
10 

1 1 The assembler could easily provide conversion of SBCS, mixed SBCS/DBCS, and pure 

12 DECS data to the UTF-8 representation, thus avoiding the need for possibly expensive run- 
time conversions for each item of Unicode data being transmitted, hi terms of the previous 

f¥ discussion: 

l|5j 1 . Specification of a request for UTF-8 conversion can be provided globally, using an 
1^ assembler option such as UTF8, or an operand on a ^PROCESS statement such as: 

# ^PROCESS UTF8 

m 2. specification of a request for UTF-8 conversion can be provided locally, using an 

operand of the ACONTROL statement, such as: 
M ACONTROL UTF8 

IB 3 . Specification of a request for UTF-8 for an individual constant can be provided by a 

22 modifier, such as: 

23 DC CUTFS'Characters to be converted to UTF-8' 

24 Thus, it can be seen that all of the methods described above for specifying the scope of 

25 conversion to Unicode can be applied to the requirements for conversion to the UTF-8 

26 representation. It should be noted that UTF-8 data is not required to occupy an even number of 

27 eight-bit bytes, so that possible checks and diagnostics for an even number of bytes would not 

28 apply- However, in situations where a length modifier causes improper truncation of a UTF-8 

29 byte string, a diagnostic would be appropriate. 



STL9-2000-0069 



38 



1 Using the foregoing specification, the invention may be implemented using standard 

2 programming and/or engineering techniques using computer programming software, firmware, 

3 hardware or any combination or sub-combination thereof Any such resulting program(s), 

4 having computer readable program code means, may be embodied within one or more 

5 computer usable media such as fixed (hard) drives, disk, diskettes, optical disks, magnetic tape, 

6 semiconductor memories such as Read-Only Memory (ROM), Programmable Read-Only 

7 Memory (PROM), etc., or any memory or transmitting device, thereby making a computer 

8 program product, i.e., an article of manufacture, according to the invention. The article of 

9 manufacture containing the computer programming code may be made and/or used by 

10 executing the code directly or indirectly from one medium, by copying the code from one 

1 1 medium to another medium, or by transmitting the code over a network. An apparatus for 

12 making, using, or selling the invention may be one or more processing systems including, but 
Q not limited to, central processing unit (CPU), memory, storage devices, communication links, 
f4' communication devices, servers, input/output (FO) devices, or any sub-components or 

U individual parts of one or more processing systems, including software, firmware, hardware or 

H any combination or sub-combination thereof, which embody the invention as set forth in the 

ff claims. User input may be received from the keyboard, mouse, pen, voice, touch screen, or any 

IS other means by which a human can input data to a computer, including through other programs 

1^^ such as application programs, databases, data sets, or files. 

2D One skilled in the art of computer science will easily be able to combine the software 

22 created as described with appropriate general purpose or special purpose computer hardware to 

23 create a computer system and/or computer sub-components embodying the invention and to 

24 create a computer system and/or computer sub-components for carrying out the method of the 

25 invention. Although the present invention has been particularly shown and described with 

26 reference to a preferred embodiment, it should be apparent that modifications and adaptations 

27 to that embodiment may occur to one skilled in the art without departing from the spirit or 

28 scope of the present invention as set forth in the following claims. 
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CLAIMS 



I claim: 



1 ] . An article of manufacture for use in a computer system for translating a non-Unicode 

2 character string stored in a memory of the computer system into a Unicode character string 

3 stored in the memory of the computer system, said article of manufacture comprising a 

4 computer-readable storage medium having a computer program embodied in said medium 

5 which causes the computer system to execute the method steps comprising: 

6 retrieving a specification of a code page in which the non-Unicode character 

7 string is encoded; 

% retrieving a specification of a scope, the scope specifying a portion of a 

computer program subject to the translation; 
IJ translating the non-Unicode character string into the Unicode character string 

tt according to the scope. 

[Hi 2. The article of manufacture of claim 1 wherein the scope is global, the global scope 

^ specifying that the translation applies to the entire computer program. 

g| 3. The article of manufacture of claim 1 wherein the scope is local, the local scope specifying 

2 that the translation applies the subsequent portion of the computer program. 

1 4. The article of manufacture of claim 1 wherein the scope is constant specific, the constant 

2 specific scope specifying that the translation applies only to a specific constant. 
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5. A method of translating a non-Unicode character string stored in a memory of a computer 
into a Unicode character string stored in the memory of the computer, said method comprising 
the steps of: 

retrieving a specification of a code page in which the non-Unicode character 
string is encoded; 

retrieving a specification of a scope, the scope specifying a portion of a 
computer program subject to the translation; 

translating the non-Unicode character string into the Unicode character string 
according to the scope. 

6. The method of claim 5 wherein the scope is global, the global scope specifying that the 
translation applies to the entire computer program. 

7. The method of claim 5 wherein the scope is local, the local scope specifying that the 
translation applies the subsequent portion of the computer program. 

8. The method of claim 5 wherein the scope is constant specific, the constant specific scope 
specifying that the translation applies only to a specific constant. 

9. A computer system for translating a non-Unicode character string stored in a memory of the 
computer system into a Unicode character string stored in the memory of the computer system, 
said computer system comprising: 

a retrievable specification of a code page in which the non-Unicode character 
string is encoded; 

a retrievable specification of a scope, the scope specifying a portion of a 
computer program subject to the translation; 

a translator for translating the non-Unicode character string into the Unicode 
character string according to the scope. 
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10. The computer system of claim 9 wherein the scope is global, the global scope specifying 
that the translation applies to the entire computer program. 

1 1 . The computer system of claim 9 wherein the scope is local, the local scope specifying that 
the translation applies the subsequent portion of the computer program. 

1 2. The computer system of claim 9 wherein the scope is constant specific, the constant 
specific scope specifying that the translation applies only to a specific constant. 
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1 ABSTRACT 

2 

3 METHOD OF, SYSTEM FOR, AND COMPUTER PROGRAM PRODUCT FOR 

4 SCOPING THE CONVERSION OF UNICODE DATA FROM SINGLE BYTE 

5 CHARACTER SETS, DOUBLE BYTE CHARACTER SETS, OR MIXED 

6 CHARACTER SETS COMPRISING BOTH SINGLE BYTE AND DOUBLE BYTE 

7 CHARACTER SETS 
8 

9 Methods for specifying the types of constants whose character values are to be 

1 0 converted to Unicode; for specifying which code page or pages are used for specifying the 

i 1 character encodings used in the source program for writing the character strings to be converted 

12 to Unicode; and that can be used to perform conversions from SBCS, mixed SBCS/DBCS, and 

1^ pure DBCS character strings to Unicode. A syntax suitable for specifying character data 

Ifl conversion from SBCS, mixed SBCS/DBCS, and pure DBCS representation to Unicode 

l^J utilizes an extension to the conventional constant subtype notation, hi converting the nominal 

ife value data to Unicode, currently relevant SBCS and DBCS code pages are used, as specified by 

l¥l three levels or scopes derived from either global options, from local AOPTIONS statement 

Ife specifications, or from constant-specific modifiers. Global code page specifications apply to 

1 ^: the entire source program. These global specifications allow a programmer to declare the 

203 source-program code page or code pages just once. These specifications then apply to all 

constants containing a request for conversion to Unicode. Local code page specifications apply 

22 to all subsequent source-program statements. These local specifications allow the programmer 

23 to create groups of statements containing Unicode conversion requests, all of which use the 

24 same code page or code pages for their source-character encodings. Code page specifications 

25 that apply to individual constants allow a detailed level of control over the source data 

26 encodings to be used for Unicode conversion. The conversion of source data to Unicode may 

27 be implemented inherently to the translator (assembler, compiler, or interpreter) wherein it 

28 recognizes and parses the complete syntax of the statement in which the constant or constants 

29 is specified, and performs the requested conversion. Alternatively, an external fimction may be 
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invoked by a variety of source language syntaxes which parses as Httle or as much of the source 
statement as its implementation provides, and returns the converted value for inclusion in the 
generated machine language of the object program. Alternatively, the conversion may be 
provided by the translator's macro instruction definition facility. 
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280 



Mapping Table for Unicode Conversion 



282 



■Header: Fixed identification Fields 



284 



Unicode character corresponding to 
source character with encoding 0 



Unicode character corresponding to 
source character with encoding 1 



286 



Unicode character corresponding to 
source character with encoding k 



288 



Fig. 2 




Issue error 
message 



316 



Set count of source characters (K) to 1 



310 




Use binary value of K-th character to index 
into K-th entry in the chosen Mapping table, 
to get K-th Unicode character; store it in "target" field 



Fig. 3 





Begin 



402 



404 



Initialize: set scan pointer to start of nominal-value in source string; 

set SBCS mode 



406 




O 



408 



420 



Step scan pointer by 1 byte 
(discard the SO character); 
set DECS mode 



Source character is the byte 
at the scan pointer position 



410 



422 



Source character is 2 bytes 
at the scan pointer position 
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412 



Translate source character 

to Unicode 
using SBCS mapping table 



Translate source character 
to Unicode using 
DECS mapping table 



Step scan pointer by 2 bytes 



426 




430 



Set SBCS mode 



Step scan pointer by 1 byte 




416 



Translation of source string completed 




418 



End 
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Title 'DCU — a macro to generate Unicode constants' 
Macro 

&L DCU &A,&Pair=Yes,&CodePage=500 

* 

Expected argument: an apostrophe-delimited string of one or 
more EBCDIC characters, with paired internal apostrophes and 
ampersands. The pairing is preserved in the output string if 

.* &Pair=Yes, and is not if &Pair=No. 

Initial limitation: max of 63 characters in quoted argument, 

.* except for paired characters if &Pair=No. 

* _____________ ■ 

.* Declare variables used internally 

LcIC &M(256) 
LcIC &V 
LcIC &R 
LclB &P 
LcIA &J 
LcIA &N 

.* Validate macro arguments 

* ^ 

Alf (N'&SysLlst gt 0).V1 Check for argument 
MNote 8,'DCU — No argument.' 
MExit 

* 

.V1 Alf (N'&SysList It 2).V2 Check single argument 
MNote 8,'DCU — More than one argument.' 
MExit 

* 

.V2 Alf (K'&Age3).V3 

MNote 8,'DCU — argument too short, or badly formed.' 
MExit 

* 

!v3 Alf (•&A'(1,1)eq""and'&A'(K'&A,1)eq"").V4 
MNote 8,'DCU — argument not properly quoted.' 
MExit 

* 

!v4 Alf ('YES' eq (Upper •&Pair')).V5 Checic if pairing wanted 
Alf ('NO' eq (Upper '&Pair')).V6 Check if no pairing 
MNote 8,'DCU — invalid value of &&Pair.' 
MExit 

* 

.V5 ANop , 

&P SetB 1 Indicate no pairing of '& in output 

* 

Fig. 5 



Mapping and validation table 
Valid EBCDIC characters 
Result Unicode string 
True if '& pairs retained in output 
Counter 
Temp 



^ 600 

.V6 ANop , 

Alf C&CodePage' eq '500').V7 Check code page 

MNote 8,'DCU — Code Page &CodePage not supported yet.' 

MExit 



* 



,V7 ANop , 

* * 

* Arguments validated. Set SBCS and Unicode character sets * 

* _* 

VX ANop , Set up mapping table 
&J SetA &J+1 

&M(&J) SetC " Initialize to null 

Alf (&J It 256).VX Loop for all 256 code points 

&V SetC •0123456789ABCDEFGHIJKLMNOPQRSTUVWXY2abcdefghijklmnopqrs* 
tuvwxyz_@#$%&&*()-+=,./: ;"<>"? ' 



The following Is the conversion table from CCSID 500 to Unicode 



&U SetC '3031 323334353637383941 42434445464748494A4B4C4D4E4F5051 5* 
2535455565758595A61 62636465666768696A6B6C6D6E6F7071 72737* 
475767778797A5F4023242526262A28292D2B3D2C2E2F3A3B273C3E2* 
23F20' 

Note: Conditional-assembly string constants require paired 
apostrophes and ampersands; ampersands are not reduced to a 
single character internally. Thus, the encoding for & appears 
twice in the &U encoding string above. 

&J SetA 1 

* * 

Build the EBCDIC-to-Unicode mapping table 

★ 

VY ANop 

&C SetC (Double '&V'(&J,1)) Pick character from valid string 

&C SetC 'C&C'" Character in self-defining term 

&N SetA &C+1 Convert to numeric 

&M(&N) SetC '&U'(2*&J-1,2) Put Unicode digits in mapping table 

&J SetA &J+1 Increment &J 

Alf (&J le K'&V).VY Set up all valid encodings 



F\Q. 6 



4 * ^ ^ 



*__ * 

.* Convert each SBCS argument character to Unicode equivalent * 

* * 

&J SetA 2 Start after initial apostrophe 

* 

.Z ANop , Head of translation loop 

&C SetC '&A'(&J,1) &J-th character from argument 
700 Alf C&C ne "" and '&C' ne •&&'(1,1)).Z1 Is it '& ? 

Alf (&P).Z1 Have '&, is pairing wanted? 

&J SetA &J+1 No pairing, step input by one 

.Z1 ANop , 

&C SetC (Double '&C') Pair '& for self-defining term 

&C SetC 'C'&C'" Change to arithmetic value 

&N SetA &C+1 Convert to numeric 

&C SetC '&M(&N)' Get Unicode mapping 

Alf C&C ne ").Z2 Validly mappable if not null 
MNote 4,'DCU — Unknown character at position &J converte* 
d to blank.' 

&C SetC '20' Unicode blank 

★ 

.Z2 ANop , 

&R SetC '&R.00&C' Add new character to end 

&J SetA &J+1 

Alf (&J It K'&A).Z Repeat for all internal characters 
* * 

/ Generate the requested Unicode constant * 

* * 

&L DC X'&R' 
MEnd 
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